Opens any fork of a file or directory for streaming access.

void PBOpenForkAsync (
    FSForkIOParam *paramBlock
);

paramBlock

A pointer to a parameter block.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function.

• ref

  On input, the file or directory containing the fork to open.

• forkNameLength

  On input, the length of the fork name in Unicode characters.

• forkName

  On input, the name of the fork to open in Unicode. You can obtain the string constants for the data fork and resource fork using the FSGetDataForkName and FSGetResourceForkName calls.

• permissions

  On input, the access (read and/or write) you want. This value controls the way the file can be accessed via the returned fork reference (read-only or read/write). It is the same as the permission parameter passed to FSpOpenDF and FSpOpenRF.

• forkRefNum

  On output, the reference number for accessing the open fork. The fork may be larger than 2GB, and is allowed to grow to 2GB or larger.

FSReadFork, FSWriteFork, FSCloseFork and related calls all require streaming access.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)